home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 January / EnigmA AMIGA RUN 33 (1999)(G.R. Edizioni)(IT)[!][issue 1999-01].iso / earcd / faq / computer-lang / ada / pal-vhdl-faq.z / pal-vhdl-faq
Internet Message Format  |  1999-01-01  |  22KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news.bbnplanet.com!cam-news-hub1.bbnplanet.com!howland.erols.net!newsfeed.internetmci.com!monmouth.edu!moncol!conn
  2. From: conn@moncol.monmouth.edu (Prof R Conn)
  3. Newsgroups: comp.lang.ada,comp.lang.vhdl,comp.answers,news.answers
  4. Subject: Public Ada Library (with VHDL support) FAQ
  5. Followup-To: poster
  6. Date: 3 Feb 1997 11:17:07 GMT
  7. Organization: Monmouth University, W. Long Branch, NJ  07764
  8. Lines: 466
  9. Approved: news-answers-request@mit.edu
  10. Message-ID: <5d4hfj$7qa@monmouth.edu>
  11. NNTP-Posting-Host: moncol.monmouth.edu
  12. Summary: Public Ada Library (PAL) Frequently Asked Questions
  13. Keywords: Public Ada Library, FAQ, PAL, Ada, VHDL, VHSIC, Integrated Circuits
  14. Xref: senator-bedfellow.mit.edu comp.lang.ada:55791 comp.lang.vhdl:11667 comp.answers:24100 news.answers:93730
  15.  
  16. Archive-name: computer-lang/Ada/pal-vhdl-faq
  17.  
  18. Date of this FAQ: 24 January 1997
  19. Public Ada Library (PAL) Frequently Asked Questions (FAQ)
  20. Posting Frequency: Monthly
  21. Last Update: 24 January 1997
  22.  
  23. The Public Ada Library (PAL) is a distributed library of Ada and VHDL
  24. software, courseware, and information that contains about 2.0 BILLION
  25. bytes of material (mainly in compressed form).   All items in the PAL
  26. have been released to the public with unlimited distribution and are
  27. freeware in most cases (the exceptions are shareware).  The PAL is
  28. managed by Professor Richard Conn at Monmouth University in New Jersey
  29. under contract to the Ada Joint Program Office, Defense Information
  30. Systems Agency, U.S. Department of Defense.  The central PAL site on the
  31. WUARCHIVE host computer can be reached through the following URLs:
  32.  
  33.   http://wuarchive.wustl.edu/languages/ada/pal.html
  34.   ftp://wuarchive.wustl.edu/languages/ada/
  35.   ftp://wuarchive.wustl.edu/languages/vhdl/
  36.  
  37. The PAL is a distributed library, and mirror (duplicate) sites are
  38. available on the Internet so that if one site is down or sluggish in
  39. responding, users may switch to an alternate.  The mirror sites include:
  40.  
  41.   http://www.cdrom.com/pub/ada/pal.html
  42.   ftp://ftp.cdrom.com/pub/ada/
  43.   ftp://ftp.cdrom.com/pub/vhdl/
  44.   http://sw-eng.falls-church.va.us/PAL/ada/pal.html
  45.   ftp://sw-eng.falls-church.va.us/PAL/ada/
  46.   ftp://sw-eng.falls-church.va.us/PAL/vhdl/
  47.  
  48. This is a short version of the PAL FAQ, designed specifically for
  49. distribution via electronic mail, which addresses the following topics:
  50.  
  51.  . Welcome to the Public Ada Library (PAL)
  52.  . What is WUArchive?
  53.  . What Electronic Mailing Lists Support the PAL Users?
  54.  . What Documentation is Available to Help the PAL User?
  55.  . What are Review Codes?
  56.  . How Do I Handle the Various Types of Files in the PAL?
  57.  
  58. A longer, more detailed version of the PAL FAQ (which addresses more
  59. questions and issues) can be accessed through the pal.html file
  60. identified above via a pushbutton.  A Postscript version of this longer
  61. FAQ is also available in the directory languages/ada/userdocs/faq in the
  62. PAL.
  63.  
  64. =======================================================
  65. Subject: Welcome to the Public Ada Library (PAL)
  66.  
  67. The Public Ada Library (PAL) is a library of Ada and VHDL* software,
  68. courseware, and documentation on the Internet-based host computer named
  69. wuarchive.wustl.edu (WUARCHIVE).  The PAL is located in the directories
  70. languages/ada and languages/vhdl if you access WUARCHIVE by FTP, archie,
  71. gopher, the World Wide Web, or FTPMAIL, or in the directories
  72. /archive/languages/ada and /archive/languages/vhdl if you access
  73. WUARCHIVE by NFS.
  74.  
  75. * VHDL stands for VHSIC Hardware Description Language, where
  76.   VHSIC stands for Very High Speed Integrated Circuit
  77.  
  78. The purposes of the PAL are:
  79.  
  80.  * to help make Ada-oriented and VHDL-oriented software, courseware, and
  81.    documentation that has been released for public distribution (as
  82.    shareware, freeware, GNU Copyleft, etc) readily available
  83.  
  84.  * to support Ada and VHDL educators by providing a convenient mechanism
  85.    for them to exchange material and ideas
  86.  
  87.  * to support the Ada and VHDL user community in general by providing a
  88.    resource in support of their activities
  89.  
  90. The support for the PAL is part of a DoD contract, entitled "Defining
  91. and Exploring an Efficient Distributed Process for the Reuse of Ada
  92. Software Components and Tools in a Global Theater" and numbered
  93. DAAB07-94-C-D009.  This contract was awarded to Monmouth University in
  94. West Long Branch, New Jersey, through the Army's Communications
  95. Electronics Command (CECOM) Software Engineering Directorate (SED) with
  96. funding provided by the Ada Joint Program Office (AJPO), Defense
  97. Information Systems Agency (DISA), U.S. Department of Defense (DoD).
  98. Professor Richard Conn of the Center for Technology Development and
  99. Transfer of Monmouth University is the principal investigator on the
  100. contract.
  101.  
  102. Many organizations have developed cooperative relationships with the
  103. PAL, contributing time, effort, user support services, and artifacts to
  104. the PAL and its users either directly or indirectly.  These
  105. organizations include:
  106.  
  107.  * the Ada Joint Program Office (AJPO)
  108.  * the Ada Information Clearinghouse (AdaIC)
  109.  * the Ada and Software Engineering Education Team (ASEET)
  110.  * the Army Reuse Center (ARC)
  111.  * the Assistant Secretary of Defense for Command, Control,
  112.    Communications, and Intelligence (ASD/C3I)
  113.  * the Asset Source for Software Engineering Technology (ASSET)
  114.  * the Comprehensive Approach to Reusable Defense Software (CARDS)
  115.  * Conservatoire National des Arts et Metiers (CNAM) in Paris, France
  116.  * the DoD's Defense Information Systems Agency (DISA)
  117.  * the Electronic Library Services and Applications (ELSA, formerly AdaNET)
  118.  * George Washington University (GWU)
  119.  * the Idaho National Engineering Laboratory (INEL)
  120.  * the Software Engineering Institute (SEI)
  121.  * the Software Reuse Repository at the University of Maine
  122.  * the Special Interest Group for Ada of the Association for Computing
  123.    Machinery (ACM/SIGAda)
  124.  * Team Ada
  125.  * the University of Alabama (UA)
  126.  * the VHDL Repository at the University of Cincinnati (UC)
  127.  * Walnut Creek CDROM
  128.  
  129. The PAL can be accessed by a wide variety of mechanisms.  These
  130. mechanisms include, but are not limited to, the following:
  131.  
  132.  * anonymous FTP to WUARCHIVE and the mirror sites
  133.  * NFS mounts on WUARCHIVE
  134.  * Gopher servers
  135.  * HyperText Transport Protocol (HTTP) servers for the World Wide Web
  136.    on WUARCHIVE and the mirror sites
  137.  * FTPMAIL email servers
  138.  * ASSET distributions and customer support
  139.  * ELSA distributions and customer support
  140.  * AdaIC distributions and customer support
  141.  * Walnut Creek CDROM electronic distributions and customer support
  142.  
  143. General Disclaimer
  144. ------------------
  145.  
  146. All software, courseware, documentation, and other items of information
  147. in the PAL are provided "AS IS" without any expressed or implied
  148. warranties whatsoever unless their individual documentation states
  149. otherwise.  No warranties as to performance, merchantability, or fitness
  150. for a particular purpose exist.
  151.  
  152. Because of the diversity of conditions under which this software may be
  153. used, no warranty of fitness for a particular purpose is offered.  The
  154. user is advised to test the software and courseware thoroughly before
  155. relying on it.  The user must assume the entire risk and liability of
  156. using this software, courseware, and documentation.
  157.  
  158. In no event shall any person or organization be held responsible for any
  159. direct, indirect, consequential, or inconsequential damages or lost
  160. profits.
  161.  
  162. =======================================================
  163. Subject: What is WUARCHIVE?
  164.  
  165. The host computer named wuarchive.wustl.edu (WUARCHIVE) is a Digital
  166. Equipment Corporation (DEC) Alpha AXP 3000 Model 400.  It is equipped
  167. with 192M bytes of RAM and over 65G bytes of disk space, and it is able
  168. to support anonymous FTP sessions, remote NFS mounts, a gopher server,
  169. and an HTTP (HyperText Transport Protocol) server for the World Wide
  170. Web.
  171.  
  172. WUARCHIVE is owned by the Office of Academic Computing and Networking,
  173. Washington University in Saint Louis. The Office of Academic Computing
  174. and Networking and the National Science Foundation have jointly paid for
  175. the hardware of the machine and for the services of the support
  176. personnel at Washington University in Saint Louis.  Additional funding
  177. for the hardware has also been provided by the AMINET User's Group, the
  178. Defense Information Systems Agency, and Monmouth University.
  179.  
  180. The maintainers of the archives which originate on WUARCHIVE are mainly
  181. volunteers, working on an unfunded basis.  The support personnel who
  182. maintain the operational support software, including the software which
  183. keeps the mirrors up to date, are funded by the Office of Academic
  184. Computing and Networking and the National Science Foundation grant.
  185.  
  186. We wish to express our gratitude to Digital Equipment Corporation for
  187. the sale of the DEC Alpha at a substantial discount and to the National
  188. Science Foundation for its grant in support of WUARCHIVE.  We also wish
  189. to express our thanks for funding for extension to the disk drives on
  190. WUARCHIVE to the AMINET User's Group, the Defense Information Systems
  191. Agency, and Monmouth University.
  192.  
  193. =======================================================
  194. Subject: What Electronic Mailing Lists Support PAL Users?
  195.  
  196. MAIL.WUSTL.EDU is the electronic mail list server for users of the PAL.
  197. A separate computer from WUARCHIVE.WUSTL.EDU (on which the PAL is
  198. located), MAIL's purpose in life from the point of view of the PAL user
  199. is to manage the electronic mailing lists supporting him.
  200.  
  201. The List Processor is a program on MAIL which manages Lists (Electronic
  202. Mailing Lists).  The user can send commands to the List Processor, and
  203. it will respond by performing actions for him (such as adding him to a
  204. List, removing him from a List, and sending him a message naming all the
  205. lists supported by the List Processor).  The user can send email
  206. messages to the List, and the subscribers to the List will receive these
  207. messages.
  208.  
  209. GENERAL INSTRUCTIONS - SUBSCRIBE, UNSUBSCRIBE, and WHICH
  210. ========================================================
  211. If you wish to subscribe to an electronic mailing list, send an
  212. electronic mail message to the List Processor:
  213.  
  214.   listproc@mail.wustl.edu
  215.  
  216. Leave the subject line blank and place the following line into the body
  217. of this message:
  218.  
  219.   subscribe <electronic mailing list name> <your name>
  220.  
  221. Example:
  222.   subscribe pal-announce John J. Smith
  223.  
  224. Begin this line in column 1.  Your return address will be used as the
  225. address to which announcements will be sent.  A list of the electronic
  226. mailing lists for the PAL user community is included below.
  227.  
  228. You will receive a message back from the List Processor, telling you of
  229. the success or failure of your request.
  230.  
  231. Once subscribed, a user can send electronic mail to all subscribers of a
  232. List by sending email to the list's name at mail.wustl.edu; example:
  233.  
  234.   ada-train@mail.wustl.edu
  235.  
  236. This, of course, only works if the List is bidirectional.  The ANNOUNCE
  237. Lists are unidirectional (read-only from the point of view of the
  238. subscribers).  Subscribers cannot post email messages to the ANNOUNCE
  239. lists - only the moderator of the ANNOUNCE lists can post messages.
  240.  
  241. If you wish to unsubscribe from an electronic mailing list, send an
  242. electronic mail message to the List Processor:
  243.  
  244.   listproc@mail.wustl.edu
  245.  
  246. Leave the subject line blank and place the following line into the body
  247. of this message:
  248.  
  249.   unsubscribe <electronic mailing list name>
  250.  
  251. Example:
  252.   unsubscribe pal-announce
  253.  
  254. If you wish to find out what electronic mailing lists you subscribe to,
  255. send an electronic mail message to:
  256.  
  257.   listproc@mail.wustl.edu
  258.  
  259. Leave the subject line blank and place the following line into the body
  260. of this message:
  261.  
  262.   which
  263.  
  264. HELP
  265. ====
  266. The List Processor is a very flexible tool which gives you control over
  267. how you receive messages from the lists to which you subscribe.  For
  268. example, you may receive messages as they are posted or in a digest form
  269. once a day.  A 20-page user's manual for the List Processor is contained
  270. in the PAL in the directory ada/userdocs/listproc.
  271.  
  272. To find out what commands the List Processor can respond to, send an
  273. email message to:
  274.  
  275.   listproc@mail.wustl.edu
  276.  
  277. which contains an empty subject line and one line in the body of the
  278. message (starting in the first column):
  279.  
  280.   help
  281.  
  282. EMAIL LIST ARCHIVES
  283. ===================
  284. Additionally, as of February 1996, all PAL email lists are archived
  285. automatically by the List Processor.  You can obtain copies of messages
  286. posted to the Lists on and after February 1996 by sending commands to
  287. the List Processor (see the user's manual for details).
  288.  
  289. A PARTIAL LIST OF ELECTRONIC MAILING LISTS AVAILABLE FROM
  290.   listproc@mail.wustl.edu
  291. =========================================================
  292.  
  293. These lists are for the PAL user community.  For a more complete list of
  294. the mailing lists available to your site, send a mail message to
  295. listproc@mail.wustl.edu which contains the command "LISTS". 
  296.  
  297.     Pal-Announce - Announcements concerning the Public Ada Library
  298.       (PAL).  These include additions to, changes to and other
  299.       announcements concerning the PAL.  You can not post messages here.
  300.  
  301.     Ada-Train - This list is for the discussion of topics concerning Ada
  302.       training and education.  This is a general discussion list.
  303.  
  304.     ASEET - The ASEET email list supports members of ASEET (The Ada and
  305.       Software Engineering Education Team) and others interested in the
  306.       activities of ASEET.  ASEET materials are available from the
  307.       Public Ada Library (PAL), including an archive of previous messages
  308.       posted to this list.
  309.  
  310.     Reuse - This list is a bidirectional mailing list for those people
  311.       interested in software reuse technology.  This includes, but is
  312.       not limited to, the fields of designing for reuse, object-oriented
  313.       reuse methods, reuse tools and environments, generic code
  314.       architectures, domain-specific kits, reuse education, technology
  315.       transfer, formal methods, certification of reusable components,
  316.       and management issues as they pertain to reuse.
  317.  
  318.     Wuarchive-Announce - Notification of any planned downtime or service
  319.       changes for wuarchive.wustl.edu.  The only announcements from this
  320.       list will be from local staff or archivers.
  321.  
  322. =======================================================
  323. Subject: What Documentation is Available to Help the PAL User?
  324.  
  325. PAL Catalog, FAQ, and Database Information
  326. ==========================================
  327.  
  328. The subdirectory userdocs/catalog in the PAL contains a number of
  329. documents of interest to the users of the PAL.  The key user documents
  330. in this subdirectory are:
  331.  
  332.      CAT_DOC.ZIP and CAT_PS.ZIP - a catalog, complete with table of
  333.        contents and index, of the contents of the PAL in the form
  334.        of a book; CAT_DOC.ZIP contains the chapters as ASCII text,
  335.        CAT_PS.ZIP contains the chapters as Postscript files that
  336.        print 2 pages per physical page in landscape (1/2 the number
  337.        of hardcopy pages required by CAT_DOC.ZIP)
  338.  
  339.      TAXONOMY.ZIP - a taxonomy of the PAL in ASCII and Postscript
  340.  
  341.      CSV_DB.ZIP - contains a Comma-Separated-Value (CSV) ASCII
  342.        text file which can be read into database managers like
  343.        dBase IV and spreadsheets like LOTUS 1-2-3 to allow the user
  344.        to scan for items of interest offline; the contents of this
  345.        ZIP file are CSV_DB.DOC and CSV_HDR.DOC, where DB contains the
  346.        data and HDR contains structure information
  347.  
  348. The subdirectory languages/ada/userdocs/catalog/id_files contains the
  349. Item Description files from which the above files were created.  Item
  350. Description files exist for each item in the PAL.  File names in
  351. id_files which have the same prefix refer to the same item.
  352.  
  353. PAL Frequently Asked Questions
  354. ------------------------------
  355. The PAL Frequently Asked Questions (PAL FAQ) list answers many of the
  356. more common questions asked by users of the PAL.  It can be found in the
  357. PAL in HTML, HTM, Postscript, and ASCII text formats in the
  358. languages/ada/userdocs/faq directory in the files faq.html, faq_a.htm,
  359. faq.ps, and faq.txt (faq.html and faq_a.htm are identical long versions
  360. of the FAQ, faq.ps is a Postscript version of faq.html, and faq.txt is a
  361. shorter version designed for distribution via email).  The file faq.txt
  362. can also be found in ASCII text form on rtfm.mit.edu under
  363. pub/usenet/news.answers/computer-lang/Ada/pal-vhdl-faq.
  364.  
  365. PAL Card Catalog in HTML
  366. ------------------------
  367.  
  368. The Public Ada Library Card Catalog is presented using HyperText Markup
  369. Language (HTML).  In this form, a user can view the Card Catalog by
  370. using a World Wide Web client, such as Netscape.  The movement and
  371. search capabilities provided by the client can be used to move through
  372. the PAL Card Catalog.
  373.  
  374. The directory languages/ada contains pal.html and pal_a.htm, the main
  375. World Wide Web home pages for the PAL and convenient entry points for
  376. the PAL Card Catalog.  The file pal.html contains the full, "glossy"
  377. home page, while pal_a.htm contains the same information for users
  378. limited to 8-dot-3 file names.  The "Contents" button in these files
  379. opens up the PAL Card Catalog at the top level of its table of contents,
  380. showing the main categories of material in the PAL.  By selecting any
  381. one of these categories, the user is shown a second level of the table
  382. of contents which details the items available under the selected
  383. category.  The "Index" button in these files opens up the PAL Card
  384. Catalog at the top level of its segmented index.  There are two indexes
  385. in the PAL Card Catalog - the segmented index is a series of HTML files
  386. for fast loading, where each file contains the index entries which share
  387. a common first character (that is, all the "A" entries are in one file,
  388. all the "B" entries in another, and so on), while the unsegmented index
  389. is a single HTML file for extensive searching, where all the index
  390. entries are in one large file (and can take a long time to load through
  391. the Web but is easily loaded if accessed through a CDROM).
  392.  
  393. The PAL Card Catalog is also available on the Walnut Creek Ada CDROM
  394. distributions of the PAL, so users may browse the CDROM using either the
  395. HTML or HTM version of the PAL Card Catalog.  The Walnut Creek Ada CDROM
  396. is formatted using the ISO-9660 standard CDROM format for a maximum of
  397. portability between different platforms, and the Rock Ridge extensions
  398. to this standard have been included.  This means that the CDROM uses
  399. 8-dot-3 file and directory names, but, if your system supports both long
  400. file names and the Rock Ridge extensions to ISO-9660, the CDROM appears
  401. with long file and directory names. For users of the CDROM without the
  402. Rock Ridge extensions (such as MSDOS, Microsoft Windows 3.x, and
  403. Microsoft Windows 95 users), the PAL Card Catalog should be accessed
  404. using the HTM (as opposed to HTML) files.  For the convenience of the
  405. users of the Walnut Creek Ada CDROM, the files 00_cd.html and
  406. 00_cd_a.htm at the top-level of the CDROM, where 00_cd.html may be used
  407. by those with long file names and support for the Rock Ridge extensions
  408. and 00_cd_a.htm may be used for those without such support.
  409.  
  410. =======================================================
  411. Subject: What are Review Codes?
  412.  
  413. The database maintained on the PAL includes Review Codes which are used
  414. to indicate to some extent the level of trust which may be placed in a
  415. particular item.  These Review Codes are defined as follows:
  416.  
  417. Code    Meaning
  418. ----    -------
  419.  
  420. AR      AdaNET Report is available (usually in the ZIP file); AdaNET
  421.         Reports contain information on experiences in compiling this
  422.         item
  423.  
  424. C1      The Certifier_1 tool has analyzed the Ada source code in this
  425.         item; the full format of this entry is "C1 n.n g" where n.n is
  426.         the version number of Certifier_1 and g is the letter grade
  427.         given by Certifier_1 (A, B, and C are satisfactory; D and F are
  428.         not satisfactory)
  429.  
  430. CMM     Comment Files (*.CMM, *.CM2, etc) are available which describe
  431.         one or more problems with the item
  432.  
  433. CS      Compiled Successfully (followed by an indication of the
  434.         Ada compiler used in parentheses) by the reviewer
  435.  
  436. ES      Executed Successfully (followed by an indication of the
  437.         target computer used in parentheses if different from the
  438.         systems mentioned in the CS list) by the reviewer
  439.  
  440. MF-CODE Missing File - Code; one or more files of source code are
  441.         missing; the item cannot be compiled without these files
  442.  
  443. MF-DATA Missing File - Data; one or more files used as input data when
  444.         the compiled code runs are missing; the item cannot be
  445.         executed without these files
  446.  
  447. NR      Not Reviewed
  448.  
  449. OK      This is a text file which is believed to be an accurate copy
  450.         of the original
  451.  
  452. RI      Review Incomplete (only some results of a partial review
  453.         are posted)
  454.  
  455. SDA     Report generated by the Ada System Dependency Analyzer is
  456.         available; if followed by a number from 1 to 5 (e.g., SDA5),
  457.         the number indicates the relative quality of the item, where
  458.         5 is of the highest quality
  459.  
  460. not     negation prefix (e.g., not ES or not OK)
  461.  
  462. =======================================================
  463. Subject: How Do I Handle the Various Types of Files in PAL?
  464.  
  465. A number of file formats have come into play among the files in the PAL:
  466.   MSDOS and UNIX ASCII text files
  467.   PAGER2 Files 
  468.   ZIP Files
  469.   GNU ZIP Files
  470.   TAR Files
  471.   Compressed (*.Z) Files
  472.   Compressed or GNU ZIPped TAR Files
  473.  
  474. If you have questions about these file formats, see the file README.TOO
  475. in the top level of the the toolkit directory.  The subdirectories under
  476. the toolkit directory contain programs for various platforms that allow
  477. you to work with these files in various ways.
  478.  
  479. Richard Conn, PAL Manager  |  conn@wuarchive.wustl.edu
  480. Opinions expressed herein are my own and not necessarily those of anyone else.
  481. ==============================================================================
  482.